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Installation Guide 


For those who prefer video guides, here are some excellent ones by ETA Prime: 


e If installing Batocera onto an x86 64 computer, Turn An Old Cheap PC Into An 
ey Emulation Dream Machine! (the controller configuration for standalone emulators 
at 18:27 is outdated, Batocera now handles controller configuration for you. For 
customizing controls per emulator, check this page) 
e If installing Batocera onto a single-board computer, Install Batocera On The 
Raspberry Pi 4 Full Setup Guide - Retro Gaming Goodness! 


Generic instructions for most platforms are as follows: 


1. Download Raspberry Pi Imager for your operating system. 


| he, amipterrpicon =se 


install Raspberry Pi OS using sid 
Raspberry Pi Imager 


Raspberry Pi Imager is the quick and easy way to install ° 
Raspberry Pi OS and other operating systems to a microSD Raspberry Pi 
card, ready to use with your Raspberry Pi. Watch our 
45-second video to learn how to install an operating 
system using Raspberry Pi Imager. 


Download and install Raspberry Pi Imager to a computer 
with an SD card reader. Put the SD card you'll use with 
your Raspberry Pi into the reader and run Raspberry Pi 
image 


d Download for Windows p 


Dow? 


Download for Ubuntu for x86 


To install on Raspberry Pi OS. type 


in a Terminal window, 


2. Download an image file from the download section on the Batocera website that matches the 
architecture you want to use for Batocera (x86_64 for most PCs, other devices usually have 
their own specific image). 
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3. Insert the intended USB drive, SD card or hard-drive into your computer. 8 GB is the minimum 
for v30 and up, 16 GB and above is recommended for full functionality (you cannot 
automatically download updates with only 8 GB). 

4. Install and run Raspberry Pi Imager. 

5. Click CHOOSE OS. 


Raspberry Pi 


m Storage 


CHOOSE OS CHOOSE STORAGE 


6. Scroll down and select Use custom. 


Other specific-purpose OS > 
Thin clients, digital signage and 3D printing operating systems 


o) Freemium and paid-for OS > 
Freemium and paid-for operating systems 


Misc utility images 
Bootloader EEPROM configuration, etc 


Format card as FAT32 


a Use custom 
4 Select a custom img from your computer 


7. Select the image batocera- (version) - (arch) - (date) .img.gz that you just downloaded. 
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Filename: —_ batocera-x86_64-36-20230306.img.gz (open _} 


Files of type: iain, [Cancel _ | 


8. Click CHOOSE STORAGE and select the USB drive, SD card or hard-drive. 


Raspberry Pi 


Operating System 


BATOCERA-X86_64-36-20230306.IMG.GZ CHOOSE STO 
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Storage x 


tf TOSHIBA TOSHIBA USB DRV USB Device - 15.5 GB 
Mounted as G:\ 


9. Click WRITE and confirm that it is the correct destination (triple-check it's the correct drive 
before proceeding, as all existing data on the drive will be destroyed!) 


Raspberry Pi 


Operating System Storage 


BATOCERA-X86_64-36-20230306.IMG.GZ 


10. Wait patiently for the writing to finish, this may take a while depending on the speed of the 
card/drive. 
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Raspberry Pi 


Operating System 


Writing... 0% 


CANCEL WRITE 


o In case the flash fails outright, try closing down any unnecessary software such as anti- 
virus programs or virtual machines and try again. 
11. Upon finishing, check that the image has been written successfully. 


batocera-x86_64-36-20230306.img.gz has been written to 
TOSHIBA TOSHIBA USB DRV USB Device 


You can now remove the SD card from the reader 


At this point, the drive contains a BATOCERA boot partition (files differ depending 
on architectures). This partition will be smaller than the total size of the drive, don't 
worry as this is just Batocera's boot partition! 


O 
Y 


Batocera.linux - Wiki - https://wiki.batocera.org/ 


Last update: 2023/11/12 05:22 install_batocera https://wiki.batocera.org/install_batocera 


— 


eS MEON JA C] 


Organize + Share with + 
ER 
File folder 


asound state 
STATE File 


batocers-boot.conf 

& (C) Local Disk CONF File 
c (E) Seagate Backup 528 byte 
am (Fx) BATOCERA 

J boot 

af 

J splesh 

J took 


12. Shut down your computer and insert your USB drive, SD card or hard-drive into the machine 
you want to boot with Batocera and turn it on. 
13. Ensure your device will boot into the USB drive, SD card or hard-drive: 
1. Most single board computers will automatically boot to the appropriate USB drive/SD card 
if only one is inserted into the system. 
2. Ifon a recent PC using an x86/x86_64 build, you may need to disable Secure Boot in your 
BIOS settings. 
3. If on a PC, you may need to enter the boot selection menu with [F10], [F11] or [F12] 
and select the Batocera drive. UEFI is preferred if available, but not necessary. 


14. Boot the Batocera drive and let it automatically expand the userdata partition (could take a few 
seconds or a few minutes, depending on your drive size/speed), it will reboot again once done. 
Don't turn off the device during this step or you might risk data corruption! 


https://wiki.batocera.org/ Printed on 2024/04/08 02:07 


2024/04/08 02:07 7/14 Installation Guide 


If instead another blue screen appears saying verification failed this means you are 
in secure boot mode and have not enrolled Batocera's keys yet. Press Enter and 
follow the on-screen prompts to do so, for further info refer to the 


15. Enjoy! © 
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Collections 


Tous les jeux 


Nombre de jeux : 106 
Favoris : 4 
Jeux joués : 39 


Le plus joué : snake [pygame] 
Dernière partie : 20/11/2020 


Be sure to check out how to add game ROMs/BIOS files required for certain emulators. Batocera's 
front-end is driven by a modified version of EmulationStation (sometimes referred to as ES). Check 
out its overview page to learn how to navigate it! 


If your Nvidia GPU is not detected, you may want to manually activate the official drivers for it to 
increase its performance, but Batocera can run fine using the default nouvaeu drivers if that isn't 
working for your machine. 


Flash failed! 


Don't panic. the imager will usually explain what went wrong in its error message, so be sure to read 
that completely. 


If using Balena Etcher to flash Batocera, and it does not state what went wrong, it's likely because of 
an ancient bug in Windows that prevents it from seeing multiple partitions on any USB drive. This can 
be fixed easily by reformatting the entire drive to NTFS and then trying again. In case Windows' own 
tools fail to do this, there are command prompt instructions below to forcefully wipe the drive. Yes, 
this is as dangerous as it sounds. 


BIOS settings (if Batocera fails to boot) 


Before troubleshooting, check if Batocera has actually booted first! Batocera has booted 
if: 


Q e The Batocera splash image appears on any connected display. 
e The SSH server is live and it is possible to log into it. 


If this is the case and you only see a blank screen, it is instead a display issue. 
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Batocera should boot fine with UEFI, if that option appears you should select that. However, 
sometimes Legacy (or MBR as it's sometimes referred to) is the only option, depending on the 
motherboard. 


Since there's no consistency between motherboard manufacturers, no step-by-step instructions can 
be provided. You can refer to University of Wisconsin Division of Information Technology's knowledge 
base page for your particular manufacturer's board on how to enter the BIOS settings on various 
motherboards during boot. Typical keys are [F12], [F11], [F10], [Del] or [End]. Typical keys for 
entering the boot selection screen are [F12], [F11], [F10], [F9] or [Del]. Some keyboards may 
require holding down the [Fn] key too. The manual that came with your motherboard can provide 
further clues, or you can try exploring all the sub-menus of the BIOS yourself. 


To access the BIOS settings from Windows, hold the [Shift] key while selecting Restart and go to 
Troubleshoot > Advanced Options: UEFI Firmware Settings. Alternatively, go to Settings > 
Change PC settings > Update and Recovery > Recovery > Advanced Startup: Restart now, 
and then upon restarting go to Troubleshoot > Advanced Options: UEFI Firmware Settings. 


Here are other known aliases BIOS's may use for various settings and what they may need to be set 
to: 


e Secure boot a.k.a. compatibility mode, compatibility support module, UEFI with CSM, etc. 
Typically in the “security” category, but can also appear in the “boot” or “authentication” 
category. You may need to disable secure boot/clear keys, regenerate keys and/or enable the 
compatibility support module (CSM) to allow other operating systems (such as Batocera) to 
boot. 

o Enroll an EFI a.k.a. add keys, secure key generation, ownership, etc. Typically in the 
“security” category, but can also appear in the “boot” or “authentication” category. Most 
motherboards should automatically add detected EFls to the list of permitted bootable 
drives, but certain motherboards require this to be a manual action. Add the file at 
EFI/boot/bootx64.efi from the Batocera boot drive. This can be avoided entirely by 
switching secure boot off. 

Legacy boot a.k.a. allow legacy ROM booting, EFI, MBR, load legacy options, show insecure 
targets, etc. Typically in the “boot settings” category, but sometimes also has its own section. 
Some motherboards will force any UEFI boots to use Secure Boot with the keys for the original 
operating system, blocking other operating systems (such as Batocera) from booting. If this is 
the case for your motherboard, a typical workaround is to use/force Legacy Boot. If neither of 
these options work, refer to the manufacturer of your motherboard for support. 

Removable Media Boot a.k.a. USB boot. Typically in the “device”, “storage” or “boot” 
category. Some motherboards may actively block the booting off of removable media such as 
USBs. This feature is typically found on office-oriented PCs. 

Boot order a.k.a. boot priority, ROM order, boot options order, UEFI Hard Disk Drive BBS 
Priorities, etc. Typically in the “boot” category, but sometimes also has its own section. Some 
motherboards may treat UEFI as one entry in boot selection, so you'll need to go to the specific 
UEFI BBS Priorities menu in the BIOS settings to switch the order to your Batocera drive first. In 
other cases it's not strictly required, but can make the Batocera drive the 'default' booting 
option when plugged in; ie. you won't have to manually select the Batocera drive to boot off it 
of every time. 


If you'd like to see a real-world example, check out this external link: 
https://www.tenforums.com/tutorials/85279-enable-disable-secure-boot-windows-10-pc.html 


If attempting to run Batocera on a computer that ordinarily runs Windows, you may have to also 
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disable these settings: 


e Fast boot a.k.a. quick boot, quick resume, hybrid sleep, etc. Typically in its own “Windows” 
category. 

¢ Windows 8/8.1/10/11 compatibility a.k.a. CSM (note no UEFI, yeah), compatibility mode, 
legacy support (for older systems), etc. Typically in its own “Windows” category. This should be 
disabled for alternative operating systems, though turning this off will mean you'll probably 
have to switch Windows itself to support legacy booting (should do so automatically). 

e TPM a.k.a. Windows 11 compatibility (yeah), TPM Security Module 2.0, USB security, etc. 
Typically in “security” category. This is a modern “feature” that can prevent alternative 
operating systems from booting up. All computers with Windows 11 preinstalled going forward 
will have this activated by default. Turning this off will likely render Windows 11 and above 
unbootable until it is switched back on, as it is a “system requirement”. 


Laptops typically have more restrictions on what they will load compared to tower PC motherboards. 
Google is your friend here. 


If all else fails, refer to the boot section on the troubleshooting page for more things to try and 
console output. 


Mac boot order selection 


To access the boot selection screen on Mac, hold the [Option] ([ALt] on ASCII keyboards) key 
while booting. On newer UEFI Macs, you may first need to turn Secure Boot to “No Security” and 
enable “Allow booting from external media” from the recovery mode (accessed by pressing and 

holding [CMD] ({[Win] on ASCII keyboards)+[R] immediately after you see the Apple logo while 
booting). 


If you hold down the [Ctrl] key on this screen, the arrow will change to a circular one; 
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(es 


Ye) 
| : 


EFI 809t 


This indicates that your machine will default to booting from this device. Hold [Ctrl ]+[Return] 
([Enter] on ASCII keyboards) to confirm. 


Install Batocera from Batocera 


Perhaps you'd like to spread the love and install Batocera onto a machine from an already set-up USB 
stick? Or maybe you just want to install Batocera directly to your hard-drive. Or maybe you want to 
prank someone. This is for that. 


When Batocera is installed onto your computer's internal hard-drive this way, all existing 
data (including your currently functional operating system) will be overwritten. There is a 
chance your motherboard may not be able to boot Batocera from the internal drive, in 

© comparison to booting from USB. Have an additional computer on-hand to be able to 
recover in case this process fails. 


If you would simply like to use your large hard-drive to store all of your 
ROMs/BIOS's/saves, refer to using external storage instead. 


This method is identical to flashing the Batocera image using Etcher. If you have the expertise and 
tools required, you should instead connect your drive directly to a running computer and flash 
Batocera using Etcher, so as to save downloading the image from the servers again. The instructions 
below are for if you cannot do that. 


@ Batocera does not install itself by copying system files over from the USB/SD card like 
other live distros might. It has to download, extract and install the image as a whole. 


1. Make sure you are connected to the internet and that your USB stick has enough free storage to 
download the Batocera image. 
2. Boot into Batocera and press [START] to open the MAIN MENU. 
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MAIN MENU 


3. Navigate to SYSTEM SETTINGS > INSTALL BATOCERA ON A NEW DISK. 
MAIN MENU 


STEM SETTINGS © 
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SYSTEM SETTINGS 


INSTALL | 


4. Select the destination you'd like to install Batocera onto. Make sure it's not the same drive 
you're currently booted off of, as that will corrupt your USB stick! 


INSTALL BATOCERA 


5. Check that you've selected the right drive. This is very easy to mess up and its actions are 
irreversible. 
6. Take a deep breath and check a third time. This is really important. 
7. Select your target architecture. It should be the same as what you selected on the 
when you first installed to your USB (most of the time, this will be X86_64). 
8. Make sure that you're sure about this. Your menu should look similar to this: 


INSTALL BATOCERA 


9. Press INSTALL. 


Depending on your internet connection, it may take a while to download and install. You cannot use 
your Batocera system while this is happening. 


If you need to install a specific version of Batocera onto your internal drive, and you have 
no way of just plugging that drive into another pite c mi the aon you want 


onto it, you can always install the latest Batocera and manually downgrade. 
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Batocera does not boot from internal drive 


A few things you can try: 


e Configure your motherboard's BIOS settings to allow loading the bootx64. efi file. This may 
involve going into a specific EFl boot-order submenu. As above, every motherboard is unique in 
this regard. 

e Manually install Batocera onto an already existing bootable EFI partition. 

e Use the MBR partitioning table instead of the default GPT. Video tutorial explaining one way of 
setting that up. 


If you're still having trouble, ensure you've also tried the above troubleshooting section or the boot 
section on the troubleshooting page. If it still fails, revert to booting from USB. 


Etcher broke my USB! 


It's actually not possible for Etcher or any flashing tool to do that. However it could be that the drive 
itself was dying and in the attempt of writing data to it one of its cells started to fail (time for a 
replacement). Refer to Etcher's article on the topic for more information, and how to possibly “save” a 
drive. These methods can also be used to “be able to use my USB again” after flashing Batocera. 


In essence, on Windows run the following from the command prompt (where # is the number of the 
desired disk): 


diskpart 

list disk 

select disk # 

clean 

create partition primary 
select partition 1 
format quick 
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